
  TSpinDblEdit  and  TDBSpinDblEdit
  Version 1.5c
   
   (c) copyright 1996-97 W. Braun  All Rights Reserved
 

   Delphi VCL-Componenten
   




Dear developer and user,

with these components you can cover all numerical entryfields
in your application and so you achieve an uniform formatted outward
shape of your application.
 
I hope these components will help you with your work and make it
a little bit easier.



Content

  
   1. Installation
   2. New
   3. Properties
   4. Description
   5. Registration
   6. Glossary	 
   7. Warranty
   8. Shareware

1. Installation 

I. Delphi 1-2 
   Please use for Delphi 1.x  "D_16.ZIP" and for Delphi 2.x  "D_32_2.ZIP".

   1. Copy the files DEdSpin.DCU (DEdSpin.DCR, DEdSpin.RES, Calc.DCU
      and Calc.DFM  into any subdirectory; e.g. C:\DELPHI\Z_COMP   
   2. Choose Options | Install Components
   3. Click Add
   4. Type the name of directory where you placed the component followed
      by DEDSPIN.DCU, e.g. C:\DELPHI\Z_COMP\DEDSPIN.DCU 
   5. Click OK
   6. Click OK

II. Delphi 3
   Please use "D_32_3.ZIP" file 
   1. Copy the files DEdSpin.DCU (DEdSpin.DCR, DEdSpin.RES, Calc.DCU
      and Calc.DFM  into any subdirectory; e.g. C:\DELPHI\Z_COMP   
   2. Choose Components | Install Components
   3. Select your favorited package ( default dclusr30.dpk) and 
      click Add.
   4. Type the name of directory where you placed the component followed
      by DEDSPIN.DCU, e.g. C:\DELPHI\Z_COMP\DEDSPIN.DCU
      or click browse to find the unit DEDSPIN.DCU  
   5. Click Compile
   6. Follow until message 'TSpinDblEdit and TDBSpinDblEdit have been registered'
   7. Save package 


In the new page on your component palette WB you will find 
TSpinDblEdit. Now you only have to click these components and 
afterwards you put then on your form at the right position.


2.  New

Version 1.5c

- Bug Cursor Position
  -by Digits=0 and ThousandSeparator=True
  -more then 2 Digits before DecimalSeparator

Version 1.5b

- Same bugfixes 
- Delphi 3 support

Version 1.5a

- DBSpinDateEdit can be used now without DataSource too
- Calculatedfields works exactly as original TDBEdit
- bug NegColor/ NegFontColor  

Version 1.5
 support of DBCtrlGrid-componente ( 32-Bit only )

Version 1.4a
 BugFixes for VK_DELETE & VK_BACK

Version 1.4

-AutoSelect
-ParentColor
-Up-/DownKey add or sub Increment to Value
 also without Spin:=True
 ( early only with visible SpinButtons)
-CalcDigitsNo : Different DigitsNo for Calculator 
 Result will be round



3.  Properties


The following properties apply to both components 
TSpinDblEdit, TDBSpinDblEdit


Properties :

Alignment       default taRightJustify                                              
AutoCalculator  boolean, pops the calculator OnEnter, default False 
CalcDigitsNo    Integer, different DigitsNo for Calculator, 
                result will be rounded.
		Please set after DigitsNo.
Calculator      boolean, Calculatorbutton on/off, default off
CalcHelpContext Integer, HelpContext for Calculator
CalcPosition    Position of Calculatorform, default posAbove
                [posAbove,posBelow,posLeft,posRight,posOnTop]
DigitsNo        Integer,  Digitsnumber  default 2, Min 0 , Max 10
Increment       double, Increment for spin
Info            InfoMessageBox about this component
MaxLength       integer, MaxLength of number (incl. Decimalseparator),
		default 10, Max 30, Min 1 ( DigitsNo = 0 )
		Normally calculated from Max-/MinValue
MaxValue	Double 
MinValue 	Double. If MinValue> = 0 and MaxValue<>MinValue then
		you can't entry negative number
NegColor	TColor, color negative Value
NegFontColor	TColor, fontcolor negative Value
PosFontColor	TColor,  fontcolor positive Value
Spin 		boolean, Spinbuttons on/off, default off
		If Spin is on use the Incrementvalue 
                like TSpinEdit (standard Delphi component )
ThousSeparator 	boolean, Thousandseparator in Value, default True 
Value 		Double

Additional  the TDBSpinDblEdit have follows properties

DataField	NumericalField , Datatype ftSmallint, ftInteger,
		ftWord, ftFloat, ftCurrency
DataSource	DataSource for Table or Query


Other Properties inherited from TCustomEdit-class.

4. Description

TSpinDblEdit serves for simplification of the entry and/or calculation
of real or integer numbers. The standardly delivered tools from
Borland are only useful for limited possibilities (look TMaskEdit). 
The entry of the numbers in TSpinDblEdit are adequate to a calculator :
the position in front of a comma from the right to the left, 
the position witch follow the comma from the left to the right. 
With the entry of negative-symbol, the actuall number will be 
answered in the negative immediatly.
The different to a calculator consists in the ability to edit 
and in the maximum quantity of the numbers before and after the 
decimal points, which are all given by the programmer.
With a normal entry of numbers the positions before then comma will
be filled up from the left and if the quantity of their maximum
is achieved, it will be changed to the first position behind the comma.
If you press the sign for decimal, the cursor jump automatically to the
first position behind the comma. 

Alignment fixes the justify of the number in the entryfield:
right(standard), centred or left.
DigitsNo is the quantity of the digitnumbers. If no numbers are inserted,
it will be filled up with zero ( e.g. 1.00 if DigitsNo = 2).
Setting will be also update CalcDigitsNo. 

If the property ThousandSeparator are True, the ThousandSeparator-Signs
will be inserted automatically and passed over by the cursor.
NegColor and NegFontColor permit an otherwise-colored performance
of the negative numbers to emphasize them optically.
MinValue, MaxValue and MaxLength are the properties to fix the max.
and min. values. These properties influence each over.
Nonsensical properties will be catched extensively 
( e.g. MinValue > MaxValue, MaxLength < Length(MaxValue)), etc.).

Value is the topical number after the arrangment of the form. 

Spin gives you the possibility for an easy addition or substraction
the topical entry with the number in the Increment-property by click
the upsign(addition) or downsign(substraction). 
You can also use the keys up or down.
Calculator places at your's employer a calculator.
After pressing the symbol for the calculator a calculatorform will
be anvanced, with this the applier can do calculations and afterwards
then applier can overtake the result in the entryfield. 

The calculator is a nonmodalform without a frame.
Calculatorform will be closed by :
-Pressing the enterkey, result will be commit to entryfield
-Klick on '<='-Button, result will be commit to entryfield
-Pressing the escapekey or click outside of calendarform, 
 result will not be commit. 





The additional properties of the TDBSpinDblEdit be useful
for databaseconnection and they can use for display and/or
manipulation the entries of the fields of the connected table or query.
Datafield can be a type of  integer or float fields. 
If the connected table or query is active during the fixing of the
properties of TDBSpinDblEdit in the development environments
( that means : the properties of the connected fields are well-known ),
the properties MaxValue, MinValue and DigitsNo will be automatically
treated as equivalent to them of the connected field and they will
not have to be worked on.  

Other Properties inherited unchanged from TCustomEdit-class.



5. Registration

Registration

Please read also the file order.txt

Price for this components is 
  -$15.00 (US) without Source 
  -$30.00 (US) with Sourcecode ( > 2000 lines ).

To order you can do this by following options :

1. CompuServe's Online Registration : GO SWREG 

   TSpinDateEdit : -File-ID 14245  without Source
                   -File-ID 14900  with    Source
   TGermDateEdit : -File-ID 15615  without Source
                   -File-ID 15616  with    Source
      Update from TSpinDateEdit : 
                   -File-ID 15617 without Source
      Update from TSpinDateEdit : 
                   -File-ID 15618 with    Source
   TSpinDblEdit :  -File-ID 12832  without Source
                   -File-ID 14901  with    Source   

2. Order by sending me an e-Mail.

3. Fill out and send the order form "order.txt"  

Registered users will receive any updates for the next year. 


The unregistered  version can use with all functions, but every month 
on the 8th this components will be open a messagewindow by creation himself 
when application is running without Delphi IDE. 



6. Glossary

If you have questions or suggestion, send me some lines by eMail or Fax.
I'm thankfull for every good proposition.



Yours, 

Wilhelm Braun
eMail : 106216.1307@compuserve.com


7. Warranty

THIS SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" AND WITHOUT 
WARRANTIES AS TO PERFORMANCE OR MERCHANTABILITY.

THESE COMPONENTS ARE PROVIDED WITHOUT ANY EXPRESS OR IMPLIED 
WARRANTIES WHATSOEVER. BECAUSE OF THE DIVERSITY OF 
CONDITIONS AND HARDWARE UNDER WHICH THESE COMPONENTS MAY BE 
USED, NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS 
OFFERED. THE USER IS ADVISED TO TEST THESE COMPONENTS THOROUGHLY 
BEFORE RELYING ON THEM. THE USER MUST ASSUME THE ENTIRE RISK 
OF USING THESE COMPONENTS. 


8. Shareware

THESE COMPONENTS ARE SHAREWARE. 
You may use the shareware version of these components for a 30 day
trial period. If you would like to continue to use these components
after the 30 day trial period, you are required to purchase the licensed
version of these components.


